home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat4 / exports.z / exports
Encoding:
Text File  |  2001-04-17  |  9.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. eeeexxxxppppoooorrrrttttssss((((4444))))                                                          eeeexxxxppppoooorrrrttttssss((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      exports - list of NFS filesystems being exported
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////eeeettttcccc////eeeexxxxppppoooorrrrttttssss
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The file /_e_t_c/_e_x_p_o_r_t_s describes the filesystems that are being exported
  16.      to NFS clients.  It is created by the system administrator using a text
  17.      editor It is processed by _e_x_p_o_r_t_f_s(1M) at system startup and by the mount
  18.      request daemon, _m_o_u_n_t_d(1M), each time a mount request is received.
  19.      _e_x_p_o_r_t_f_s should be re-executed after making changes to the file.
  20.  
  21.      The file consists of a list of filesystems, the _n_e_t_g_r_o_u_p(4) or machine
  22.      names allowed to remote mount each filesystem and possibly a list of
  23.      options.  The filesystem names are left justified and followed by a list
  24.      of names separated by white space.  The names are looked up in
  25.      /_e_t_c/_n_e_t_g_r_o_u_p and then in /_e_t_c/_h_o_s_t_s.  A hyphen indicates the start of
  26.      the options list.  Multiple options are separated by commas.  The default
  27.      options are rrrrwwww,,,,aaaannnnoooonnnn====nnnnoooobbbbooooddddyyyy.
  28.  
  29.      rrrroooo        Export the directory read-only.  If not specified, the
  30.                directory is exported read-write.
  31.  
  32.      rrrrwwww====_h_o_s_t_n_a_m_e[::::_h_o_s_t_n_a_m_e]...
  33.                Export the directory read-mostly.  Read-mostly means exported
  34.                read-only to most machines, but read-write to those specified.
  35.                If no hosts are specified, the directory is exported read-write
  36.                to all.
  37.  
  38.      aaaannnnoooonnnn====_u_i_d  If a request comes from a host for uid 0 (typically ``root'')
  39.                or from a host using null authentication, use _u_i_d as the
  40.                effective user ID.  _u_i_d can be either a name or an integer user
  41.                ID from /_e_t_c/_p_a_s_s_w_d.  The default value for this option is
  42.                ``nobody'' (uid -2).  Because uid 0 permits access to files
  43.                regardless of permission and ownership, NFS servers change uid
  44.                0 to the anonymous uid by default.  Use the rrrrooooooootttt option to
  45.                permit accesses from hosts using uid 0.  Setting the value of
  46.                _u_i_d to -1 disables accesses from unknown users or from root on
  47.                hosts not included in the rrrrooooooootttt option.
  48.  
  49.      rrrrooooooootttt====_h_o_s_t_n_a_m_e[::::_h_o_s_t_n_a_m_e]...
  50.                Give root access only to the root (uid 0) users from a
  51.                specified _h_o_s_t_n_a_m_e.  The default is for no hosts to be granted
  52.                root access.
  53.  
  54.      aaaacccccccceeeessssssss====_c_l_i_e_n_t[::::_c_l_i_e_n_t]...
  55.                Give mount access to each _c_l_i_e_n_t listed.  A _c_l_i_e_n_t can either
  56.                be a hostname, or a netgroup (see _n_e_t_g_r_o_u_p(4)).  Each _c_l_i_e_n_t in
  57.                the list is first checked for in the /_e_t_c/_n_e_t_g_r_o_u_p database and
  58.                then in the /_e_t_c/_h_o_s_t_s database.  The default value allows any
  59.                machine to mount the given directory.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. eeeexxxxppppoooorrrrttttssss((((4444))))                                                          eeeexxxxppppoooorrrrttttssss((((4444))))
  71.  
  72.  
  73.  
  74.      nnnnoooohhhhiiiiddddeeee    Allows a client who mounts this entry's parent filesystem to
  75.                access files in this filesystem.  This is ``off'' by default,
  76.                preventing a client who mounts this entry's parent filesystem
  77.                from accessing files in this filesystem.  Clients who mount a
  78.                filesystem containing a hidden filesystem access the directory
  79.                on which the hidden child is mounted, not the child
  80.                filesystem's root directory.  Be aware that using this option
  81.                introduces a violation of RFC 1094, RFC 1813, and the XNFS
  82.                specification.  Using this option may cause the server not to
  83.                interoperate properly with non-IRIX clients, particularly Linux
  84.                clients.
  85.  
  86.      wwwwssssyyyynnnncccc     Causes all writes to this filesystem to be performed
  87.                synchronously.  With this option, the server waits until
  88.                written data is safely stored on a magnetic disk or other non-
  89.                volatile medium before sending a positive response to the
  90.                client.  Without this option, the server performs delayed
  91.                writes (it responds positively to the client, then writes the
  92.                data at its convenience or when a _s_y_n_c(2) is executed).
  93.                Delaying writes provides a great performance boost, but also
  94.                introduces the risk of losing data if the server crashes after
  95.                the response but before the data is stored.  Use the wwwwssssyyyynnnncccc
  96.                option if this risk is unacceptable.
  97.  
  98.      33332222bbbbiiiittttcccclllliiiieeeennnnttttssss
  99.                Causes the server to mask off the high order 32 bits of
  100.                directory cookies in NFS version 3 directory operations.  This
  101.                option may be required when clients run 32-bit operating
  102.                systems that assume the entire cookie is contained in 32 bits
  103.                and reject responses containing version 3 cookies with high
  104.                bits on.  IRIX 5.3 and Solaris 2.5 are examples of 32-bit
  105.                operating systems with this behavior, which produces error
  106.                messages like "Cannot decode response" on directory operations.
  107.                XFS filesystems on the server can generate cookies with high
  108.                bits on.  Exporting filesystems with the 33332222bbbbiiiittttcccclllliiiieeeennnnttttssss option
  109.                causes these bits to be masked and prevents error messages.
  110.  
  111.      A filesystem name that is not followed by a name list is exported to
  112.      everyone.  A ``#'' anywhere in the file indicates a comment extending to
  113.      the end of the line on which it appears.  A backslash ``\'' at the end of
  114.      a line permits splitting long lines into shorter ones.  When splitting
  115.      the options across multiple lines, the character immediately preceeding
  116.      the backslash must be one of ``-'', ``='', ``:'', or ``,''.  Also, no
  117.      whitespace may follow the backslash nor proceed the first character of
  118.      the next line.
  119.  
  120. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  121.           /usr/local               # export to the world
  122.           /usr      clients        # export to my clients
  123.           /usr2     bonnie clyde   # export to only these machines
  124.           /usr3     -anon=guest    # map client root & anonymous to guest
  125.           /         -ro            # export the root filesystem
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. eeeexxxxppppoooorrrrttttssss((((4444))))                                                          eeeexxxxppppoooorrrrttttssss((((4444))))
  137.  
  138.  
  139.  
  140.           /usr      -ro,nohide     # export all local filesystems read-only
  141.           /d/local/src   \
  142.                     -rw,anon=guest,root=bonnie    # multi-line example
  143.  
  144.      Exporting all your machine's local filesystems requires enumerating all
  145.      local mount points and using nnnnoooohhhhiiiiddddeeee for filesystem other than root:
  146.  
  147.           /         -ro
  148.           /usr      -ro,nohide
  149.           /d        -ro,nohide
  150.  
  151.  
  152. NNNNOOOOTTTTEEEE
  153.      The nnnnoooohhhhiiiiddddeeee and wwwwssssyyyynnnncccc options are specific to IRIX.
  154.  
  155. FFFFIIIILLLLEEEESSSS
  156.      /etc/exports
  157.  
  158. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  159.      exportfs(1M), mountd(1M), showmount(1M), netgroup(4), passwd(4).
  160.  
  161. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  162.      You cannot export a directory that is either a parent- or a sub-directory
  163.      of one that is currently exported and within the same filesystem.  It
  164.      would be illegal, for example, to export both /_u_s_r and /_u_s_r/_l_o_c_a_l if both
  165.      directories resided in the same disk partition.
  166.  
  167.      While there is no hard-coded maximum length, extremely long export lists
  168.      (hundreds of hosts or netgroups for a single exported directory) may
  169.      cause mount requests for that exported directory to time out.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.